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Section 1: Introduction to ‘Line A' 


TOS provides two software interfaces to its graphics routines: VDI and Line A. This 
document describes the "Line A" interface to the ST‘s low-tevel graphics primitives, as provided in all 
ST computers with TOS in ROM. 11 assumes you are familiar with the ST's operating system and 
68000 assembly language. 

While VDI is appropriate for many applications, it is sometimes advantageous to give up 
some convenience for speed and additional features, like support for all 16 Bit Bit logic operations in 
TextBIt. Line A provides an interface for simple graphics operations, with these additional features. 


Line A Opcodes 

Since Line A is an "underlying" portion of TOS, its interface to the world is designed more for 
the convenience of the operating system than for humans. The Line A interface consists of 16 
opcodes, each of which is one word in length. The upper 4 bits are 1010 (A in hex, hence Line A ) 
and the lower 12 bits are used as the opcode field. The 15 opcodes are' 


Initialization ($A000) 

Put Pixel <$A001) 

Get Pixel ($A002) 

Arbitrary Line (SA003) 

Horizontal Line (SA004) 

Filled Rectangle ($A005) 

Filled Polygon ($A006) 

BitBIt <$A007) 

TextBIt ($A008) 

Show Mouse (SA009) 

Hide Mouse (SA00A) 

Transform Mouse ($A00B) 

Undraw Sprite ($A00C) 

Draw Sprite ($A00D) 

Copy Raster (SA00E) 

Seedtill (SA00F) 


Return Line A pointers 
Draw a pixel 

Return the value of a pixel 
Draw an arbitrary line 
Draw a horizontal line 
Draw a filled rectangle 
Draw one hline of a filled polygon 
Move/copy a section of memory 
Move text to the screen 
Show the mouse pointer 
Hide the mouse pointer 
Transform the mouse pointer 
Undraw software "sprite" 

Draw software "sprite" 

Copy raster memory form 
Seedfill 


To use Line A (in two easy steps): 


•Set up the input variables for the functions you need. 

-Declare a constant word of $A00X, where X is fhe number of your function. * 

When the 68000 encounters the $A00X opcode, it performs a "Line A” exception, executes 
the Line A function, and returns control 1o your code. 
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Section 1: Introduction to 'Line A’ 


Most Line A functions depend on a structure in memory for input parameters. The Line A Init 
call, JA000, returns a pointer to this structure in both aO and dO, The Line A variables are accessed 
relative to this value. Here’s a diagram: 

aO points to - 

2(a0) ’ ' I I 

, | — ; 


1 VPLANES 

(word) 

♦0 

1 

1 VWRAP 

(word) 

+2 

1 

1 CONTRL 

(long) 

+4 

i 

i INTIN 

(long) 

+8 

i 


Once you have the pointer to this structure, you can use the Line A "offsets" to address 
specific variables. Some variables, like VPLANES (number of bit planes in current resolution), are 
global variables that reflect the current state ol the system. Others, like XI and Y1, are areas for 
passing parameters to Line A, which you must set up yoursell. For a list of these offsets, see 
Section 3, "The Line A Variable Structure". 

Line A allows your application to set "clipping boundaries" for many of its functions. These 
boundaries are set with the XMINCL, XMAXCL, YMINCL, and YMAXCL variables, which limit where 
Line A is allowed to draw. This prevents it from "coloring outside the lines." This is handy if you want 
to have an onscreen "window", and make sure Line A doesn’t disturb anything outside its boundaries. 

Many Line A functions support clipping. A few that do not are Init (obviously), PutPixel, 
GetPixel, Line, Horizontal Line, and BitBIt. 
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Section 2 : Line A Function Reference 


$A000 -- Initialization 

Returns several usetul pointers, including the pointer to the Line A Variable Structure. 


Input: None. 


Returns: 

DO - 
AO - 
A1 •= 

A2 « 


pointer to Line A variable structure 
pointer to Line A variable structure 

pointer to a null terminated array ol pointers to the system font headers, allowing you 
to point to custom fonts in the TextBIt call. 

pointer to a null terminated array of pointers to the Line A routines, allowing you to 
call the routines directly without incurring the overhead of processing a Line a 
exception. (You MUST be in supervisor mode to do this.) 


Notes: 


In order to make calls to most Line A routines, you will need to make thiscajl once to get a 
pointer to the Line A Variable Structure. Once you have that pointer, ssve it somewhere, and 
you needn't use Line A init again. 


Example: 


dc.w SA000 


; Make the Line A Init call 
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Section 2: Line A Function Reference 


*A001 -- Pul Pixel 

Plots a single pixel at the given X and Y coordinates 
Input: 


INTIN[0] * Color value to use when plotting the pixel 
PTSINI[0] * x coordinate lor pixel 
PTSIN[1 j * y coordinate lor pixel 

Returns: Nothing. 

Notes: 


This function receives Its parameters via the INTIN and PTSIN arrays. The Line-A Variable 
Structure contains pointers to these arrays, at oflsets +8 and +C, respectively. Offsets within 
the INTIN and PTSIN arrays are given in words. 

The function flself is straightforward Build a PTSIN array containing the x and y coordinates 
for the pixel, build an INTIN array containing the color you want for the pixel, set Line-A s 
INTIN and PTSIN variables to point to your arrays, and perform the PutPixel call. 

Example: 


; Plot a pixel at (10,10) with color 1 

dc.w $A000 

move! •int,INTlN(a0) 

move.! “point, PTSlN(aD) 

dc.w $A001 


Make Line A Init call 
Address of WTIN array 
Address of PTSIN array 
Put Pixel 


.data 

; Define the INTIN and PTSIN arrays. 

fnt: dc.w 1 

point: dc.w 10.10 
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Section 2: tine A Function Reference 


$A002 *• Gel Pixel 

Gets the value ol a single pixel at the given X and Y coordinates Returns this value In dO. 

Input: 

PTSINlO] «■ X coordinate of pixel 
PTSIN[1] * Y coordinate of pixel 

Returns: 

DO * value of the pixel 

Notes: 

Code for using this function is very similar to that for PutPixel; Instead of putting a pixel on the 
screen, it returns the value of a pixel in dO. 

Example: 


Return the value of pixel at 
(10,10) in dO 

dc.w $A000 

move. I *point,PTSIN(aO) 

dc.w $A002 


; Init Line-A 
; Address ol PTSIN 
; Get Pixel 


.data 

; Define the PTSIN array... 
point: dc.w 10,10 
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Section 2: Line A Function Reference 


$A003 - Arbitrary Line 

Draws a tine between the (X1.Y1) and (X2.Y2). The line can be vertical, horizontal, or diagonal. If 
you know the line is horizontal, Horizontal Line ($A004) is slightly faster 

Input. 

word 
word 
word 
word 

word 

word 
word 
word 
word 
word 
word 


Side Effects: 

LNMASK is rotated to align with the right-most endpoint. 
Returns: Nothing. 

Notes: 


COLBITO 

m 

bit value for plane 0 

-*■024 $018 

COLBIT 1 

m 

bit value tor plane 1 

+026 $01 A 

COLBIT2 

• 

bit value for plane 2 

+028 $01C 

COLBIT3 

m 

bit value for plane 3 

+030 $01 E 

LSTLIN 

* 

Draw last pixel of line? 
(0»yes 1*no) 

+032 $020 

LNMASK 

* 

line style mask 
(line pattern) 

+034 $022 

WMODE 

m 

writing mode 

+036 $024 

XI 

m 

XI coordinate 

+038 $026 

Y1 

m 

Y1 coordinate 

+040 $028 

X2 

m 

X2 coordinate 

+042 $02A 

Y2 

« 

Y2 coordinate 

+044 $02C 


LNMASK is a one-word mask containing the pattern of the line. WMODE determines what 
mode a line is drawn in, replace, transparent, reverse transparent, or XOR mode. 

LSTLIN determines if the last pixel of a line is drawn. If LSTLIN is nonzero, the last pixel will 
NOT be drawn. This is helps prevent two connected lines from XORing a common endpoint 
out of existence. 

Example: 


; draw a solid tine from (0,0) to (100,100) 

dc.w $A000 
move.w •I.COLBITO(aO) 
move.w •1,COLBIT1(aO) 
move.w *1,COLBIT2(aO) 
move.w •1,COLBIT3(aO) 
move.w *0,LSTLIN(a0) 
move.w •$FFFF,LNMASK(a0) 
move.w *0,WMODE(a0) 
move.w •O.XKaO) 
move.w •O.YKaO) 
move.w *100,X2(a0) 
move.w *100,Y2(a0) 
dc.w $A003 


; Make Line A Inlt call 
; set COLBIT variables 


, draw last pixel of line 
; line style mask 
; writing mode (replace) 

; (xl.yl)and (x2,y2) into 
; appropriate variables 


; Arbitrary Line 
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Section 2: Une A Function Reference 



$A004 -• Horizontal Line 

Draw a horizontal line between (X1.Y1) and (X2.Y1). Horizontal line is slightly faster than the 
Arbitrary Line function. 


Input: 


COLBITO 

m 

bit value for plane 0 

+024 $018 

word 

COLBIT 1 

m 

bit value for plane 1 

+026 $01 A 

word 

COLBIT2 

m 

bit value tor plane 2 

+028 $01C 

word 

COLBIT3 

K 

bit value for plane 3 

+030 $01E 

word 

WMODE 

m 

Writing mode 

+036 $024 

word 

XI 

m 

XI coordinate 

+038 $026 

word 

Y1 

m 

Y1 coordinate 

+040 $028 

word 

X2 

m 

X2 coordinate 

+042 $02A 

word 

PATPTR 

m 

Pointer to fill pattern 

+046 $02E 

long 

PATMSK 

m 

Pattern index 

+050 $032 

word 

MFILL 

m 

multi-plane pattern flag 

+052 $034 

word 



Returns; Nothing 
Notes: 

PATPTR points to an array of line patterns 

The line pattern is chosen from the array of line patterns based on Y1 AND PATMSK. 
PATMSK should equal the number of line patterns in the array minus one. 

If MFILL is nonzero, alt planes will be filled with the values in the COLBITs. This overrides 
WMODE, since a multi-plane fill will happily perform a REPLACE of the destination bitplanes 
with no regard for the WMODE. 

Example: 


; Draw a dashed line from (0,10) to (10,100) 
dc.w $A000 

move w *1,COLBIT0(a0) 

move w •1,COLBIT1(aO) 

move.w *1,COLBlT2(aO) 
move w *1,COLBlT3(aO) 
move.w •0,WMDDE(a0) 
move.w •0,X1(a0) 
move.w *10,Y1(a0) 
move.w *100,X2(aO) 
move.l *pat,PATPTR(a0) 

move.w •0,PATMSK(a0) 
move.w •0,MFILL(a0) 
dc.w $A004 


.data 

pat: dc.w $F0F0 


; Line A Init 

; set COLBIT variables 


writing mode (replace) 
xl , y 1 . and x2 into 
appropriate variables 

pattern pointer 
Pattern length n-1=0 
Multiple Plane fill off 
Horizontal Line 


; Pattern for line. 
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Section 2: Line A Function Reference 


$A005 *.* Filled Rectangle 

Draw a filled rectangle with upper left corner at (X1.Y1), and lower right corner at (X2.Y2). 



Input: 


COLBITO 

m 

bit value for plane 0 

+024 $018 

word 

COLB1T1 

m 

bit value (or plane 1 

+026 $01 A 

word 

COLBIT2 

m 

bit value for plane 2 

+028 $01C 

word 

COLBIT3 

at 

bit value for plane 3 

+030 $01E 

word 

WMODE 

B 

writing mode 

+036 $024 

word 

XI 

m 

XI coordinate 

+038 $026 

word 

Y1 

m 

Yt coordinate 

+040 $028 

word 

X2 

m 

X2 coordinate 

+042 $02A 

word 

Y2 

m 

Y2 coordinate 

+044 $02C 

word 

PATPTR 

m 

Pointer to the fill pattern 

+046 $02E 

long 

PATMSK 

m 

Fill pattern index 

+050 $032 

word 

MFILL 

m 

Mult ! -lane fill pattern flag 

+052 $034 

word 

CLIP 

m 

clipping flag 

+054 $036 

word 

XMINCL 

m 

X minimum tor clipping 

+056 $038 

word 

XMAXCL 

m 

X maximum for clipping 

+058 $03A 

word 

YMINCL 

m 

Y minimum for clipping 

+060 $03C 

word 

YMAXCL 

m 

Y maximum lor clipping 

+062 $03E 

word 


Returns: Nothing. 
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Section 2: Line A Function Reference 


Draw a filled rectangle with Its upper 
left corner at (0,0) and its lower right 
corner at (100,100). Clip the rectangle 
to within (0,0) and (50,50). 


.data 

tuji: 


dc.w 

$A000 

move w 

•I.COLBITO(aO) 

move w 

•I.COLBITKaO) 

move w 

•1,COLBIT2(aO) 

move w 

•1,COLB1T3(aO) 

move w 

•O.WMODE(aO) 

move w 

•O.XKaO) 

move w 

•0,Y1(a0) 

move w 

*100,X2(a0) 

move w 

•100,Y2(a0) 

move l 

•fuji,PATPTR(a0) 

move w 

»15,PATMSK(aO) 

move.w 

•0,MFILLC-'» 

move.w 

*1,CLIP(aO) 

move w 

•O.XMlNCL(aO) 

move.w 

*50,XMAXCL(a0) 

move w 

•O.YMINCL(aO) 

move.w 

•50,YMAXCL(a0) 

dc.w 

$A005 

dc.w 

$0000 

dc.w 

$05 AO 

dc.w 

$05A0 

dc.w 

S05A0 

dc.w 

S05A0 

dc w 

SODBO 

dc.w 

SODBO 

dc.w 

S1DB8 

dc.w 

$3990 

dc.w 

$799E 

dc w 

$718E 

dc.w 

$718E 

dc.w 

$6186 

dc w 

$4182 

dc.w 

$0000 

dc w 

$0000 


; Line A init 
; bit planes for shape 


; writing mode (replace) 

; X and Y values tor shape 


; pattern pointer to fuji 
; Pattern length * 16*1 * 15 
; multi-plane fill (off) 

; clipping status (on) 

; clipping boundaries 


; Filled Rectangle 


0000000000000000 
0000010110100000 
0000010110100000 
0000010110100000 
0000010110100000 
0000110110110000 
0000110110110000 
0001 1101 1011 1000 ' 
0011100110011100 
0111100110011110 
0111000110001110 
0111000110001110 
0110000110000110 
0100000110000010 
0000000000000000 
0000000000000000 


Section 2: Line A Function Reference 


$A006 -- Filled Polygon 


Draws a filled polygon line-by-line. 


Input: 


PTSINfl 

CONTRLUJ 

COLBITO 

COLBIT1 

COLBIT2 

COLBIT3 

WMODE 

Y1 

PATPTR 

PATMSK 

MFILL 

CUP 

XMINCL 

XMAXCL 

YMINCL 

YMAXCL 


Pointer to an array ot polygon vertices 
<(x1.y1),(x2,y2)...(xn,yn) 1 {x1,y1)) 


n ■ number ol vertices 
bit value tor plane 0 
bit value lor plane 1 
bit value tor plane 2 
bit value for plane 3 
writing mode 

y coordinate of scan-line to fill 
Pointer to the fill pattern 
Fill pattern index 
Multi-plane fill pattern flag 
clipping flag 
X minimum for clipping 
X maximum for clipping 

Y minimum for clipping 

Y maximum for clipping 


+024 $018 

word 

+026 $01 A 

word 

+028 $01C 

word 

+030 $01 E 

word 

+036 $024 

word 

+040 $028 

word 

+046 $02E 

long 

+050 $032 

word 

+052 $034 

word 

+054 $036 

word 

+056 $038 

word 

+058 $03A 

word 

+060 $03C 

word 

+062 $03E 

word 


Side Effects: 


AO is destroyed 

Xt and X2 are destroyed. 

Returns: Nothing. 

Notes: 


The first vertex must be repeated at the end of the list of n endpoints. 


Filled polygon requires CONTRL to point to an array in which the second word contains the 
number of vertices. This is handled in the example program by the line "control: dc.w 
O.NUMVERTS". 


PTSIN must point to an array ol vertices in the format XI, Y1, X2, Y2, X3, Y3, and so on. 
Each coordinate is a word in length. In the example, this is handled by the array starting at 
"verts:". 


The polygon is drawn one line at a time. The Y coordinate is contained in Y1. To till an 
entire polygon, a simple loop increments Y and performs the Filled Polygon call repeatedly. 
In the example, this is done by a routine called "loop". 
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Section 2: Line A Function Reference 


Example: 


; Draw a polygon with vertices at (0,0). 

; (319,120), and (25,199). One line is 
; drawn at a time. The clipping variables 
; are set but not evaluated, since CLIP 
; is set to 0 (oft). 

TOP equ 0 

BOTTOM equ 199 

NUMVERTS equ 3 

PATLENGTH equ 15 


Uppermost Y in polygon 
Lowermost Y in polygon 
number of vertices 
length of pattern 


dc.w 
move.) 
move. I 
move.w 
move.w 
move.w 
move.w 
move.w 
move I 
move w 
move.w 
move w 
move w 
move w 
move.w 
move w 


JA000 

•verts, PTSIN(aO) 

•control, CONTRL(aO) 

•I.COLBITO(aO) 

•I.COLBITKaO) 

•1,COLBIT2(aO) 

•1,COLBIT3(aO) 

•O.WMODE(aO) 

•fuji.PATPTR(aO) 

•PATLENGTH, PATMSK(aO) 

•0,MFILL(a0> 

•0,CLIP(a0) 

•O.XMINCL(aO) 

•100,XMAXCL(a0) 

•O.YMINCL(aO) 

•100,YMAXCL(a0) 


Line-A init 
Address of verts 
Address of "control- 


writing mode (replace) 
address of pattern 
length of fill pattern 
Multi*plane fill (off) 
clipping status (off) 
clipping boundaries 


; Main loop to draw the 

polygon 

move.l 

a0,a5 

move.w 

•TOP,Y1(a5) 

move.w 

•BOTTOM. d4 

sub.w 

•TOP,d4 

loop: dc.w 

SA006 

addq 

•1,Y1(a5) 

dbra 

d4,loop 


Save aO in a5. 

Maximum y to Y1 
Maximum y into d4 
minus minimum y 
Filled Polygon (one line) 
Decrement current Y 



Section 2: Line A Function Reference 


.data 

control: 

dc.w 

0.NUMVERTS 

verts: 

dc.w 

0,0,319,120,25.199.0,0 

fuji: 

dc.w 

$0000 

dc.w 

S05A0 


dc.w 

$05 A0 


dc.w 

$05A0 


dc.w 

$05 A0 


dc.w 

$0DB0 


dc.w 

$0DB0 


dc.w 

$1DB8 


dc.w 

$399C 


dc.w 

$799E 


dc.w 

$718E 


dc.w 

$718E 


dc.w 

$6186 


dc.w 

$4182 


dc.w 

$0000 


dc.w 

$0000 


; CONTRU1]- no. ol verls 

; 0000000000000000 
; 0000010110100000 
; 0000010110100000 
; 0000010110100000 
; 0000010110100000 
; 0000110110110000 
; 0000110110110000 
; 0001110110111000 
; 0011100110011100 
; 0111100110011110 
; 0111000110001110 
; 0111000110001110 
; 0110000110000110 
; 0100000110000010 
; 0000000000000000 
' oooooooooooooooo 


Section 2: Una A Function Reference 


SA007 - BitBIt 

Perlorm a BIT BLock Transfer 
input: 


a6 - pointer to the BitBIt parameter block 

The BitBIt routines receive information through their own parameter block, the address of 
which must be put into a6 before the bitblt call is made. The format ol this block Is shown 
below. This block must be 76 bytes long, including 24 bytes at the end for use by the Bit 
Variables marked with a (D) may be destroyed during the blit. 


B_WD 

+00 ($00) 

(word) 

Width of block to blit (in pixels) 

B_HT 

+02 ($02) 

(word) 

Height of block to blit (in pixels) 

PLANE_CT 

+04 ($04) 

(word) 

Number of consecutive planes to blit {D} 

FG_COL 

+06 ($06) 

(word) 

Foreground color (logic op index:hi bit) ID) 

BG_COL 

+08 ($06) 

(word) 

Background color (logic op indexlo bit) (D) 

OP_TAB 

+10 ($0A) 

(long) 

Logic ops for all fore and background combos 

S.XMIN 

+ 1 4 ($0E) 

(word) 

Minimum X: source 

S_YMIN 

+16 ($10) 

(word) 

Minimum Y: source 

S_FORM 

+18 ($12) 

(long) 

Source form base address 

S_NXWD 

+22 ($16) 

(word) 

Offset to next word in line 
(in bytes) 

SJMXLN 

+24 ($18) 

(word) 

Offset to next line in plane 
(in bytes) 

S_NXPl 

+26 ($1 A) 

(word) 

Offset from start of current plane to next plane 

D.XMiN 

+28 ($1C) 

(word) 

Minimum X: destination 

D.YMIN 

+30 ($1E) 

(word) 

Minimum Y: destination 

D.FORM 

+32 ($20) 

(long) 

Destination form base address 

(For example, Physbase of the screen.) 

D.NXWD 

+36 ($24) 

(word) 

Offset lo next word in line 
(in bytes) 

D_NXLN 

+38 ($26) 

(word) 

Offset to next line In plane 
(in bytes) 

DJMXPl 

+40 ($28) 

(word) 

Offset from start of current plane to next plane. 

P_ADDR 

+42 ($2A) 

(long) 

Address of pattern buffer 
(0=no pattern) 
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Section 2: Line A Function Reference 


-as. 


P_NXLN 

+46 ($2E) 

(word) 

Offset to next line in pattern 
(in bytes) 

P_NXPL 

+48 ($30) 

(word) 

Offset to next plane in pattern 
(in bytes) 

P_MASK 

+50 ($32) 

(word) 

Pattern index mask 

SPACE 

+52 ($34) 

24 bytes 

Extra Space, required by the blit. Be sure to define 
this or the next 24 bytes of memory will be clobbered, 
resulting in a mangled image or worse! 



SFORM and D_FORM point to the first words of the source memory form and destination memory 
forms, respectively. These addresses must be on word boundaries. 

S NXWD and D NXWD are offsets to the next word in a plane of the memory form. For example, in 
a monochrome mode screen the value is 2, in medium resolution, 4, and in low resolution, 8. 

S NXLN and D_NXLN are fo...i widths for source and destination. These widths must be even byte 
vaiues since they represent the offset from one row of the form to the next and forms must be word 
aligned and an integral number of words wide (hint: The hi rez screen value is 90 while low and 
medium rez values are 160.) 


S NXPL and D NXPL are offsets from the start of one plane to the start of the next plane Because 
of the ST screen's interleaved plane structure, this value is always two. Alternative universes allow 
for a series of contiguous planes where NXPL values are the number of bytes in each plane. Thus, it 
is possible to BLT from the contiguous universe into the interleaved ST universe and vice versa. 


The actual bit aligned blocks of memory are defined within the form by an upper left anchor point, a 
pixel width, and a pixel height: (S_XMIN, S_YMIN, B_WD, and B HT). The location in the 
destination form is defined by an anchor point (D_XM1N, D_YMIN). No harm will come if these two 
areas overlap. Note that no dipping is performed and there is no checking to determine whether the 
bit blocks tall within the confines of the encompassing memory forms. Finally, the number of planes 
to be transferred (the number of iterations of the BLT algorithm) is contained in the PLANE_CT word 


OP_TAB is a table of four RASTER OP codes. Each of the byte wide entries In OP.TAB contain a 
code for one of the sixteen logical operations between source and destination blocks. For each 
plane, the logical operation is chosen by indexing into the OP_TAB with a value derived from the 
FG COL and BG COL words. For a given plane ”n", bit "n" of FG_COL is the hi bit of the two bit 
index value and bit "n* of BG_COL is the lo bit of the index value: 

FG(n) BG(n) OP TAB entry 


0 

0 

1 

1 


0 

1 

0 

1 


first byte 
second byte 
third byte 
fourth byte 


For each unique combination ol FG and BG, a specific logic operation can be defined with OP_TAB. 


BitBtt Logic Oos 


S 

D 

D’ 


Source pixel 
Destination pixel 
Destination after operation 
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Section 2: Line A Function Reference 


OP Combination Rule 

0 D’-O 

1 D' - S AND D 

2 D’ - S AND INOT D] 

3 D' - S (Replace Mode) 

4 D’ * (NOT S] AND D (Erase Mode) 

5 D' -D 

6 D’ * S XOR D (XOR mode) 

7 D' « S OR D 

8 D' - NOT (S OR D] 

9 D’ * NOT (S XOR D] 

A D’ - NOT D 

B D' - S OR [NOT D] 

C D’ * NOT S 

D D’ * [NOT S] OR D 

E D‘ * NOT [S AND D] 

F D’ * 1 

Patterns 

Patterns are word-wide, word-aligned images that are logically ANDed with the source prior to the 
logical combination of source and destination. 

Patterns are packed in an imaginary grid anchored at the upper left corner (0,0) ot the destination 
memory form. 

Patterns are 16 bits wide and repeated every 16 pixels horizontally. 

Patterns are an integral power ol 2 in height and repeat vertically at that frequency. (1,2, 4,8,...) 

The source is shifted into alignment with the destination rectangle prior to the combination of source 
with pattern. Thus, the relationship between source and pattern is dependent upon the X,Y 
positioning of the destination rectangle. 

P_ADDR points to the first word ot the pattern. If this pointer is 0, a pattern is not combined with the 
source rectangle. 

P_NXLN is the offset (in bytes) between consecutive words in the pattern. This number should be an 
InTegral power of two (2, 4, 8...) 

P NXPL is the offset (in bytes) from the beginning of a plane to the beginning of the next plane. In 
the case of a single plane pattern used in a multi-plane environment, this value would be zero, inus, 
the same pattern is repeated through all planes. 

PJvfASK works with P_NXLN to specify the length ot the pattern. The length (in words) of the 
pattern must be an integral power of two. 

If P_NXLN = 2 ~ n 

then P_MASK * (length in words -1) « n 

To BLT from a single plane source to multi-plane destination, S_NXPt ■ 0. The same source plane 
is BLTed to all destination planes. To map Is to foreground color and Os to background color, set 
OP TAB lo: 
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pftsgt 

Logic Op 


+00 

00 

All zeros 

+01 

04 

D' <- INOT Si AND D 

+02 

07 

D' <- S OR D 

+03 

15 

All ones 


Load foreground color Into FG_COL and background color into BG_COL. 


To map Is to foreground color and make Os transparent set OP_TAB to: 


PttS-fci 

Logic Op 


+00 

04 

D’ <- INOT S] AND D 

+01 

04 

D' <- INOT SI AND D 

+02 

07 

D' <- S OR D 

+03 

07 

D’ <- S OR D 


Load foreground color into FG_COL; BG_COL is irrelevant. Be sure S_NXf?L is set to 0. 


To BLT a pattern without Source to the Destination, define a word of ones, and set S_FORM at it. 
Set S_NXLN, S_NXPL, S_NXWD, S_XMIN, and S_YMIN to 0. Set up the pattern as you usually 
would. The BLT will create a pattern-filled rectangle. 

To make a simple sprite-like device, build a monoplane mask. Everywhere there is a 1 jn the mask, 
the background will be removed. Wherever a 1 falls, the background is left intact. Set OP_TAB to: 


Offset 

Logic Op 


+00 

04 

O’ <- [NOT Si AND D 

+01 

04 

D' <- [NOT S3 AND D 

+02 

07 

D’ <- S OR D 

+03 

07 

D’ <- S OR D 


Load foreground color into FG_COL; BG_COL is irrelevant 

Take a monoplane form (or multi-plane lorm) and "OR” it (OP 7) into the area that you Just scooped 
out with the mask. 

Example: 
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BitBIt a monochrome invertebrate 
to the screen. 


move.w 

*2.-(sp) 

; get screen base address 

trap 

•14 


addq 

•2,sp 


move.l 

dO, screen 


lea 

blit,a6 

; address of blit parameter block 

dc.w 

$A007 

; BitBIt 


data 

BitBIt Parameter Block 


blit: 


screen: 



dc.w 

$0030 



width of source in pixels 

dc.w 

$0014 



height of source in pixels 

dc.w 

$0001 



number of consecutive planes to blit 

dc.w 

$0001 



fg color (logic op index: hi bit) 

dc.w 

$0000 



bg color (logic op index: lo bit) 

dc.l 

$07070707 


logic ops for all fg and bg combos 

dc.w 

$0000 



minimum X: source 

dc.w 

$0000 



minimum Y: source 

dc.l 

Slug 



source form base address 

dc.w 

$0002 



byte oftset to next word in line 

dc.w 

$0006 



byte offset to next line in plane 

dc.w 

$0002 



offset to next plane (in bytes) 

dc.w 

$00FF 



minimum X: destination 

dc.w 

$0064 



minimum Y: destination 

dc.l 

$00000000 


destination form base address 

dc.w 

$0002 



byte offset to next word in line 

dc.w 

$0050 



byte offset to next line in plane 

dc.w 

$0002 



offset to next plane (in bytes) 

dc.l 

$00000000 


address of pattern butter 


■ 



(0=no pattern) 

dc.w 

$0000 



byte offset to next tine in pattern 

dc.w 

$0000 



byte offset to next plane in pattern 

dc.w 

$0000 



pattern index mask 

dc.w 

$0000, 

$0000, 

$0000. $0000 

dc.w 

$0000, 

$0000, 

$0000. $0000 

dc.w 

$0000, 

$0000, 

$0000, $0000 
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Image definition from: 

NEOchrome cut buffer contents (left justified): 

pixels/scanline K $0030 (bytes/scanline: $0006) 

• scanlines (height) * $0014 

Monochrome mask (1 plane; background*0/non-background*1) 


dc.w 

$0000, 

$0000, 

$0030, 

$0000, 

$0000, 

dc.w 

$006C, 

$0000, 

$0000, 

$00CE, 

$0000, 

dc.w 

$0000, 

$0196, 

$0000, 

$0000, 

$03B0, 

dc.w 

$0000, 

$0000, 

$0760, 

$0000, 

$0000, 

dc.w 

$7FC0, 

$0000, 

$0003, 

$FFC0, 

$0000, 

dc.w 

$00FF, 

$FFE0, 

$0000, 

$1FFF, 

$FFF0, 

dc.w 

$0FFF, 

$FFFF, 

$FF70, 

$1FFF, 

$FFFF, 

dc.w 

$FFE0, 

$FFFF, 

$FFFF, 

$FFC0 



Note: This example might not be admissable in a programming class, 
"dc w-s. In the real world, you’d probably want to copy all this into 


$0066, $0000, $0000 
$0000, $O0CC, $0000 
$0000. $0000, $0770 

$OEE0, $0000, $0000 

$003F, $FFC0, $0000 
$01FF, $FFFF, $FEF0 
$FF80, $FFFF, $FFFF 


since it changes some of its 
jr bss, then make the changes. 


16 


Section 2: Line A Function Reference 



$A008 -- TextBIt 

Perform a TEXT BLock Transfer of 1 character 



Input: 


WMODE 

« Writing mode 

♦036 $024 

word 

CLIP 

(0-3 «>VDi modes, 4-19 «>BitBlt modes) 

- clipping flag +054 $036 

word 

XMINCL 

* X minimum for clipping 

♦056 $038 

word 

YMINCL 

* Y minimum for clipping 

♦058 $03A 

word 

XMAXCL 

* X maximum for clipping 

♦060 $03C 

word 

YMAXCL 

* Y maximum for clipping 

♦062 $03E 

word 

XDDA 

* accumulator for x dda 

♦064 $040 

word 

DDAINC 

■= fractional amount to scale 
up or down 

♦066 $042 

word 

SCALDIR 

* scale direction flag (0*down) 

♦068 $044 

word 

MONO 

* mom paced font flag 

+070 $046 

word 

SOURCEX 

* x coord of character 
(in font form) 

+072 $048 

word 

SOURCEY 

» y coord of character 
(In font form) 

+074 $04 A 

word 

DESTX 

- x coord of character 
(in destination form) 

♦076 $04C 

word 

DESTY 

* v coord of character 
(in destination lorm) 

+078 $04E 

word 

DELX 

- width of character 

♦080 $050 

word 

DELY 

• height of character 

♦082 $052 

word 

FBASE 

■ Pointer to start of font data 
(font form) 

♦084 $054 

long 

FWIDTH 

« Width of lont form 

♦088 $058 

word 

STYLE 

* TextBIt special effects flags 

♦090 $05A 

word 

LITEMASK 

« mask for lightening text 

♦092 $05C 

word 

SKEWMASK 

» mask for skewing text 

+094 $05E 

word 

WEIGHT 

* width by which lo thicken text 

♦096 $060 

word 

ROFF 

■ offset above character baseline 
when skewing 

♦098 $062 

word 

LOFF 

* offset below character baseline 
when skewing 

♦ 100 $064 

word 

SCALE 

« scaling flag (0 => no scaling) 

♦ 102 $066 

word 

CHUR 

- character rotation vector 

♦ 104 $068 

word 

TEXTFG 

* Text foreground color 

+ 106 $06A 

word 

SCRTCHP 

■ pointer to start of text 
special effects buller 

♦ 108 $06C 

long 

SCRPT2 

■ offset of scaling buffer 

In SCRTCHP buffer (midpoint) 

♦112 $070 

word 

TEXTBG 

■ Text background color 

+114 $072 

word 


Notes: 

Most of the effort for TextBIt goes into setting up its variables, as shown above. The 
Information you need about the font itself is contained In the font header, as described in tne 
VDI manual under "Font Format". Not all of the variables are always evaluated, as the 
example shows Check Section 3, "The Line A Variable Structure," for more information on 
the TextBIt variables and their uses 

After TextBIt outputs one character, it automatically increments its X coordinate by the width 
of the character primed. 
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TextBIt allows the tour VDI writing modes, as well as the BitBlt modes. VDI modes 1*4 are 
TextBIt 0*3, and BitBlt modes 0-15 are TextBIt modes 4-19. 

When using special etiects, make sure the butter pointed to by SCRTCHP is large enough to 
contain the worst case (largest) result ot the ettects * 2. SCRPT2 must be an offset from the 
beginning to the midpoint of this butler. 


Example: 


; Font Header Offsets 


first_ade equ 

36 

ofMable equ 

72 

data_table equ 

76 

lorm_width equ 

60 

form_height equ 

62 


; header offset to value of first displayable 
; character in font 

; header offset to pointer to offset table 
; header offset to pointer to font data 
; header offset to total width of lont 
; header offset to total height of font 


Print a null-terminated string using 
TextBIt 


dew 

$A000 

; Line A Init 

move.w 

*2,WMODE(aO) 

; writing mode (VDI XOR) 

move.w 

*0,CLIP(a0) 

; Clipping status (off) 

move.w 

•0,XMINCL(aO) 

; clipping boundaries 

move.w 

•125,XMAXCL(aO) 


move.w 

•O.YMINCL(aO) 


move.w 

•200,YMAXCL(aO) 


move.w 

•I.TEXTFG(aO) 

; Foreground color 

move.w 

#0,TEXTBG(a0) 

; Background color 

move.w 

•lOO.DSTX(aO) 


move.w 

»100,DSTY(a0) 


move.w 

*4,STYLE(aO) 


move.w 

*0,SCALE(a0) 


move.w 

•1,MONO(aO) 


system fonts 



move.l 

4(a1),a1 

; Address of 8x8 font 

move! 

data table(a1),FBASE(a0) 

; Address of font data 

move.w 

form width(a1),FWIDTH(a0) 

font form width 

move.w 

»orm_height(a1),DELY(a0) 

; height of font 


Print the string 
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print: 

leal 

move.l 

clr.l 

move.b 

ble 

sub.w 

isl.w 


move.w 

move.w 

sub.w 

move.w 

clr.w 

movem.l 

dc.w 

movem.l 

bra 

dienow: 

rts 

.data 

string: 

dc.b 


string. a2 

off_tab)e(a1),a3 

dO" 

(a2)+,d0 

dienow 

first ade(a1),d0 
•1.00 

0(a3,dO),SRCX(aO) 

2(a3,d0),d0 

SRCX(aO).dO 

dO.DELX(aO) 

SRCY(aO) 

a0-a2,-(a7) 

$A008 

(a7)+,a0-a2 

print 


a2 -> string to print 
address of offset table 
make sure dO is dear 
character from string 
end of string, exit 
letter's oflset in font 
x2 for _word_ oflset In 
offset table 
x of desired character 
x of next character 
minus x of desired char 
width of desired char 
start at top of char 
push everything on the stack 
TextBIt 

put everything back 
print next character 


"Welcome to TextBIt, Space Guy!",0 
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$A009 -- Show Mouse 
Show the mouse cursor. 

Input: 

INTIN[0] (optional, see Notes, below.) 

Returns: Nothing. 

Useful Variables: 

The depth at which the mouse cursor Is hidden is held in HIDE CNT at 

This variable will be zero It the mouse is shown, and non-zero it hidden. The numoer is now 

many "shows” must be performed to show the mouse cursor. 

The x and y coordinates ol the mouse cursor are held in GCURX and GCURY, at *602 (- 
$25A) and -600 (-$258). 

The mouse button status is held in MOUSE_BT at -596 (-1254). See Section 3, "The Line A 
Variable Structure", tor more information. 


Notes: 


It Hide Mouse has been used more than once, an equivalent number ot Show Mouse calls 
must be made to be effective. To lorce the mouse cursor to be shown regardless oi now 
many hides have occured, put a word of zero into INTIN[0]. 


Example: 


dc.w 


$A009 
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$A00A -- Hide Mouse 
Hide the mouse cursor. 
Input: None. 

Returns: Nothing. 
Notes: 


It you use more than one Hide Mouse, it must be countered with an equivalent number of 
Show Mouse calls to show again. This is explained in "Show Mouse", above. 

Example: 

dc.w $A00A 
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SAOOB -• Transform Mouse 
Transform the mouse’s form, 
input: 

iNTIN = pointer to an array ot parameters 
Returns: Nothing. 

Notes: 

This function gets its parameters and data from an array pointed to by INTIN. This array 
contains information like the "hot spots" tor the mouse pointer, colors lor the new mouse 
pointer, and the actual shape of the new mouse pointer. 

The existing mouse pointer information is contained in the Line A variable Structure, starting 
at -856 (-$356). This information can be saved away before you change the mouse cursor 
and be used to restore it to its former self. 

Also, mouse Jtag at -339 (-$153) determines if the mouse interrupts are enabled, and can be 
used to prevent the mouse cursor from being updated while changing its form. (Be sure to 
restore mousejlag to its previous value when you're done.) 

Example: 


Replace the familiar arrow with a 
short message. 


HOTX 

equ 

HOTY 

equ 

MASKC 

equ 

DATAC 

equ 


dc.w 


move! 


dc.w 


dc.w 


dc.w 


0 

0 

0 

1 

$A000 

•mouse, INTIN(aO) 

$A00A 

$A00B 

$A009 


; Mouse hot-spots 
; color data 


Init Line A 

address of mouse data 
Hide Mouse 
Transform Mouse 
Show Mouse 


; mouse data 


mouse: dc.w 

dc.w 
dc.w 
dc.w 
dc.w 
dc.w 
dc.w 
dc.w 
dc.w 


rtOTX ; x hot spot 

HOTY ; y hot spot 

t ; Reserved, must be 1... 

VtASKC ; Mask color Index 

DATAC : Data color index 

50000, $0000, $0000, $0000,$FFFF,$FFFF,$FFFF $FFFF 

JFFFF $FFFF $0000, $0000, $0000, $0000,$0000, $0000 

$0000 $0000, $0000, $0000, $0002, $632A,$50AA,$5798 

$638A $4030, $0000, $0000, $0000, $0000, $0000, $0000 
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> 


$A00C -- Undraw Sprite 
Undraw the previously drawn sprite. 

Sprites are useful for animating small objects, since Line-A takes care of the housekeeping 
for you Sprites are 16x16, and consist of two "layers": an image and a mask. 

When a sprite is drawn, the screen image "under" It is copied into the sprite save block. 

When that sprite is undrawn, the screen is restored to its original state. 

When using multiple sprites, undraw in reverse order of drawing. If any one sprite intersected 
anolher, it will have copied part of the underlying sprite away into the sprite save block. If you 
undraw in order, the underlying sprite will be restored to background, erasing the "top sprite. 
When the top sprite is undrawn, it will restore a part of the underlying sprite. This causes 
what is called (in computer graphics) a "mess". 


Input: 

A2 * Pointer to sprite save block 
Side Effects: 

A6 is destroyed. 

Notes. 

The sprite save block is used to save the screen underneath the sprite. Its size is 10 bytes + 
64 bytes per plane: (10 + (VPLANES * 64)) bytes. 

Example: 

See draw sprite, below. 
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$A00D -- Draw Sprite 
Draw a software sprite. 
Input: 


D1 ■ Y hot_spot 

AO « pointer to sprite definition block 
A2 » pointer to sprite save block 

Side Effects: 


A6 is destroyed. 


Returns: Nothing. 


Notes: 


The sprite save block is used to save the screen underneath the sprite. Its size is 10 bytes + 
64 bytes per plane: (10 + (VPLANES * 64)) bytes. 

The Sprite Definition Block is laid out as follows: 


Pesc.riB.tign 

X offset of sprite hot-spot 
Y offsel of sprite hot-spot 
Format flag (see below) 

Background color (Physical pixel color) 
Foreground color (Physical pixel color) 
Sprite image. 


I I IS I VI I I Id I nay USICI I I III ICJ I iwrw ll ie Hill vw — " — — , 

format flag is 1, VDI format is used, if -1, XOR is used. The two modes are compared below. 


Offset 

Size 

000 $000 

word 

002 $002 

word 

004 $004 

word 

006 $006 

word 

008 $008 

word 

010 $00A 

64 bytes 


FG bit BG bit 

VDI 0 0 

Mode 0 1 

1 0 

1 1 

XOR 0 0 

Mode 0 1 

1 0 

1 1 


Action 

Destination (screen) color 
Background color plotted 
Foreground color plotted 
Foreground color plotted 

Destination (screen) color 
Background color plotted 
Invert destination (screen) color 
Foreground color plotted 


The sprite image is designated as alternating words of background and foreground image, like. 


word 0 
word 1 
word 2 
word 3 


background line 0 
foreground line 0 
background line t 
foreground line 1 


Example: 
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GCURX 

equ 

-602 

GCURY 

equ 

-600 

MOUSE.BT equ 

-596 

Iood: 

move.w 

•37,-(sp) 


trap 

• 14 


addq 

*2,sp 


dc.w 

SA00A 


lea 

save,a2 


dc.w 

$A00C 


; Draw a sprite tied to the mouse position 


dc.w 

$A000 

move.w 

GCURX(a0),d0 

move.w 

GCURY(a0),d1 

lea 

sprite, a0 

lea 

save.a2 

dc.w 

SA00D 

dc.w 

$A000 

move.w 

MOUSE BT(aO),d3 

btst 

d3,»1 

bne 

loop 

dc.w 

$A009 

rts 



; Sprite save block 

save: ds w 5 

ds.w 32 


data 


Sprite data 


; Current mouse X position 
; Current mouse Y position 
; Mouse button status 

; Wait for VSYNC 


; Hide Mouse 
; Image save area 
: Undraw Sprite 


tnit Line-A 
x position 
y position 
sprite image data 
image save area 
Draw Sprite 
Init Llne*A 

Mouse button status 
Check right button 
If not, loop 
Show Mouse 


; Storage for misc. info 
; Storage for sprite image 


sprite: dc.w 

dc.w 
dc.w 
dc.w 
dc.w 
dc.w 
dc.w 
dc.w 
dc.w 
dc.w 
dc.w 
dc.w 
dc.w 
dc.w 
dc.w 
dc.w 
dc.w 
dc.w 
dc.w 
dc.w 
dc.w 


x offset of hot spot 
y offset of hot spot 
lormat flag 
background color 
; foreground color 

koooo 1 1 11111 1 1000,%000001 1 1 1 1 1 ioooo 
>4,0001 111111111 100,%00001 11111111000 
&00 1111111111111 0,%000 1111111101100 
&001 1111111111 1 10, %0001 100000000100 
X >001 1 111111111 1 10,%0001 100000000100 
&001 11111111111 10,%0001 000000000 100 

54,001 1111111111 1 10,%0001 1 110001 11100 

54,001 11111111111 10, %000101 1 101010100 

54,001 1111111111 1 10,%0001000100000100 
54,0001 11111111 1 100,%0000101 100101000 
54,0001 1 1111111 1 1 00, %0000 110111011 000 
54,0000 1111111111 00, %00000 11000101000 
%00001 1 1 1 1 1 1 1 1000,%000001 1 1 1 1010000 
%01 1111111111 1000,%00101 11000010000 
%01 1 1 1 1 1 1 1 1 1 10000, %001 1 1001 1 1100000 
%01 1 1 1 10000000000, %001 1 100000000000 
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$A00E -- Copy Raster 

Same as VDI’s Copy Raster functions, but with the Line*A call you needn’t open a virtual workstation. 
See VDI manual under "Raster Operations" 
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$A00F - Seedfill 

Same as VDI’s Contour Fill function, with the following exceptions: 


You needn't open a virtual workstation 


You MUST set the dipping variables correctly. They are evaluated regardless of the state ot 
the clipping flag 


SEEDABORT is a vector to a routine called at the end 
continues based on the value returned in DO; if zero, it 


of each line till. Seedfill aborts or 
continues, it nonzero, it aborts. 


30 


Section 3: The Line A Variable Structure 


The following is a chart of the Line A Input Variables Structure. It shows the name of the 
variable, Its offset from the beginning ol the table (in decimal and hex), its size, and a brie I 
description ol its function. The top of this chart is lower in memory than the bottom. Note: variables 
that begin with "V_" are used by the ST BIOS character output routines. 


NAME 

QEESEI 

S1ZEL 

DESCRIPTION 


-910-S38E to 
-906 -$38A 


RESERVED 

CUR.FONT 

-906 -$38A 

long 

pointer to current font header 


•902 -$386 to 
-856 -$356 


RESERVED 


The next 37 words contain mouse cursor information, including the mask, 
form, hot spot, and writing mode. 

M_POS_HX 

-856 -$356 

word 

Mouse hot spot x coordinate within the 
16x16 mouse cursor 

M_POS_HY 

-854 -$354 

word 

Mouse hot spot y coordinate within the 
16x16 mouse cursor 

M_PLANES 

-852 $352 

word 

Writing mode for mouse cursor. 


1 Indicates "norma!" mode, -1 indicates XOR mode. There are two 
"planes" ol information in the mouse cursor, representing the F(oreground) 
and B(ackground). The table below shows the displayed result forthe four 
possible combinations in these "planes" for both the "normal and XOR 
modes. 


0 

1 

1 


B 

0 

1 
0 
1 


Norm 

Dest. 

B 

F 

F 


XOR 

Dest. 

B 

NOT Dest. 
F 


Destination color is unchanged 

"Background" mouse color shown 

"Foreground" color shown, or destination color is inverted 

"Foreground" color shown 


M_CDB_BG 
M_CDB_FG 
MASK FORM 


-850 -$350 
-848 -$34E 
-846 -$34C 


#ord Mouse background physical pixel color 

word Mouse foreground physical pixel color 

Location of system mouse cursor 
mask and form. 


Alternating words ol background and foreground data, like: 
background word 0, foreground word 0.. .background word 15, foreground 
word 15. 


INQ TAB 


-782 -$30E words 45 words, containing the information 

returned by the vq_exlnd VDI call. 
(See VDI manual.) 
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DEVJTAB 

-592 -$2B4 

words 

45 words, containing the information 
returned by the v opnwk VDI call. 
(See VDI manual) 

GCURX 

-602 -$25A 

word 

Current mouse cursor x position 

GCURY 

-600 -$258 

word 

Current mouse cursor y position 

M_HtD_CT 

-598 -$256 

word 

Depth at wNch the mouse cursor is 
currently "Ndden”. 


When the mouse cursor is hidden, this variable contains a non-zero 
value. An application can check this location lo determine how deep 
thecursor is Ndden. An application can also lorce the mouse cursor to be 
shown regardless of how deep it is hidden via the "Show Mouse call. 


MOUSE_BT -596 -$254 word Current mouse button status 


Bit 0 - left button status (0=up, 1-down) 

Bit 1 * right button status (0-up, 1 -down) 

One way to check the mouse button status. Another is CUR_MS_STAT. 

REG COL -594 -$252 words 3*16 words of internal data for 

- vq_color (See VD1 manual.) 


SIZ.TAB 


-498-$1F2 words 15 words, containing text, line, and 

marker sizes in device coordinates: 

0 min char width 

1 min char height 

2 max char width 

3 max char height 

4 min line width 

5 reserved 

6 max line width 

7 reserved 

6 min marker width 

9 min marker height 

10 max marker width 

1 1 max marker height 
12-14 RESERVED 



-468 -$1D4 

word 

RESERVED 


-466 -$1D2 

word 

RESERVED 

CUR.WORK 

-464 -$1D0 

long 

Pointer to current virtual workstation 
attributes 

DEF.FONT 

-460 -$1CC 

long 

Pointer to default font header 

FONT.RING 

-456 -$1C8 

longs 
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FONT RING is sn array of four longword poiniers lo linked lists ol 
font headers. The first entry is the head pointer to the font list, the second 
and third are continuation fields, and the fourth is a null terminator When the 
VDI searches through the list and encounters a null pointer In the link field of 
a font header, It continues the search from the next continuation field in 
FONT RING. If this field is zero, the search ends. The first two pointers in 
FONT~RING are initialized for resident font lists, and the third la the pointer to 
the GDOS fonts, which is normally reinitialized during each VDI call. 

FONT RING[3] is always zero to end VDIs quest lor fonts. 


When an application requests a specific font size and type, the 
system searches its lists tor the first occurrence of the requested style. When 
found VDI searches for the correct height. This search is terminated when 
VDI encounters another style In the header, or when a zero Is found in 
FONT_RING. Ail fonts of the same style must be linked together in 
ascending order. 

The first font header In a set of user installed fonts should be pointed 
to by FONT_RING[0], and the link field in the header ol the last user-installed 
font should contain the pointer it finds in FONT_RING[Oj. 


FONT_COUNT 

•440 -$1B8 

word 

Number ol fonts in the FONT_RING 
lists 


-436 -$1B6 to 
-348 -$15C 


RESERVED 

CUR_MS_STAT 

-348 -$15C 

byte 

Mouse status 


Bit 0 * left mouse button status (0-up, 1-down) 

Bit 1 * righl mouse button status (0*up, 1-down) 

Bit 2 * reserved 
Bit 3 * reserved 

Bit 4 * reserved „ 

Bit 5 - mouse movement flag (0*no movement, 1 -movement; 

Bit 6 * right mouse button change flag (0-no change, 1 -change) 
Bit 7 - left mouse button change flag (0-no change, 1 -change) 


One way to get the current mouse status. In addition to the mouse 
button status, it provides flags indicating if the mouse has mo \ e p :p' 1 *'• ® r _, 
the mouse buttons have changed from the last mouse interrupt (bits 6 and 7). 



-347 -$15B 

byte 

RESERVED 

V_HID_CNT 

-346 -$15A 

word 

Hide depth of alpha cursor 

CUR_X 

-344 -$158 

word 

Mouse cursor X position 

CUR_Y 

-342 -$156 

word 

Mouse cursor Y position 

CUR_FLAG 

-340 -$154 

byte 

Nonzero - draw mouse form on 
VBLANK. 
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CUR X, CUR_Y, and CUR_FLAG 
the VBLANK'mouse cursor draw routines, 
cursor will be drawn are followed by a flag 
should be drawn on the next VBLANK. 


make up a Communication block to 
The X and Y at which the mouse 
indicating If the mouse cursor 


MOUSE_FLAG 

-339 $153 

byte 

Non-zero If mouse Interrupt processing 
is enabled 


-338 -$152 

long 

RESERVED 

V_SAV_XY 

-334 -$14E 

word 

Saved alpha cursor X coordinate 


-332 -$14C 

word 

Saved alpha cursor Y coordinate 

SAVE_LEN 

-330 -$14A 

word 

height of saved form (number of lines 
saved from screen) 

SAVE.ADDR 

-32« -$148 

long 

Screen address of first word saved 
from screen 

SAVE.STAT 

-324 -$144 

word 

Save Status 


bit 0 *> 

1 = info in buffer is valid. 

0 * info in buffer is not valid. 


bit 1 «> 

It 1 , double-word wide area was saved. 
If zero, word wide area was saved. 


bits 2-15 RESERVED 


SAVE.AREA 


-322 -$142 


Save up to 4 planes, 16 longwords per 
plane. 


SAVE.LEN, SAVE.ADDR, SAVE_STAT, and SAVE_AREA are used 
by the systemlo save the screen from under the mouse cursor. 


USER TIM 
NEXT "TIM 


-066 -$042 long 

-062 -$03E long 


USER TIM is a pointer to a user installed routine executed on each 
system timer tick. When done, this routine should * d 

NEXT_TIM. For more information, see the VDI manual under Exchange 
Tirrw»r Inlerrunt Vector." 


USER.BUT 

-058 -$03A 

long 

USER.CUR 

-054 -$036 

long 

USER_MOT 

-050 -$032 

long 

V_CEL_HT 

-046 -$02E 

word 

V_CEL_MX 

-044 -$02C 

word 


User button vector 

User cursor vector 

User motion vector 

Height ol alpha cell In pixels 

Maximum alpha cell X 
Number ol cells across -1 
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V_CEL_MY 

-042 -$02A 

word 

Maximum cell Y 
Number ol cells high -1 

V_CEL_WR 

-040 -1028 

word 

Byte displacement to next vertical 
alpha cell 

V_COL_BG 

•038 -$026 

word 

Physical color index oi background 
color 

V_COL_FG 

-036 -$024 

word 

Physical color index of foreground 
color 

V_CUR_AD 

-034 -$022 

long 

Current alpha cursor address 

V_CUR_OF 

-030 -$01E 

word 

Byte oftsel from screen base to top ol 
first cell 

V_CUR_XY 

-028 -$01C 
-026 -$01 A 

word 

word 

Alpha cursor position: cell x 
Alpha cursor position: cell y 

V.PERIOD 

-024 -$018 

byte 

Alpha cursor flash period (in frames) 

V_CUR_CT 

-023 -$017 

byte 

Alpha cursor counidown timer to next 
toggle ol the cursor form 

V_FNT_AD 

-022 -$016 

long 

Address ol monospace font data 

V_FNT_ND 

-018 -$012 

word 

Last ASCII code in font 

V_FNT_ST 

-016 -$010 

word 

First ASCII code in font 

V_FNT_WD 

-014 -$00E 

word 

Width of font form in bytes 

V_REZ_HZ 

-012 -$00C 

word 

Horizontal pixel resolution 

V_OFF_AD 

-010 -$00A 

long 

Address of font offset table (per VDI 
spec) 


-006 -$006 

word 

RESERVED 

V_REZ_VT 

-004 -$004 

word 

Vertical pixel resolution 

BYTES J.IN 

-002 -$002 

word 

Width of destination memory form: set 
with same value as in WIDTH 

PLANES 

+000 $000 

word 

Number ol bit planes in current 
resolution 

WIDTH 

+002 $002 

word 

Contains the width ol the destination 
memory form (usually screen) In bytes. 


Low resolution: $A0 (160 decimal) 
Medium resolution: $A0 (160 decimal) 
High resolution: $50 (80 decimal) 

CONTRL 

+004 $004 

long 

Pointer to CONTRL array 
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INTIN 

PTSIN 

WMTOUT 

PTSOUT 

COLBITO 

COLB1T1 

COLBIT2 

COLBIT3 


LSTLIN 


LNMASK 

WMODE 


+008 $008 

long 

+012 $00C 

long 

+016 $010 

long 

+020 $014 

long 

+024 $018 

word 

+026 $01 A 

word 

+028 $01C 

word 

+030 $01E 

word 


Pointer to INTIN array 
Pointer to PTSIN array 
Pointer to INTOUT array 
Pointer to PTSOUT array 


Current color bit*p!ane values for plane 
0, 1, 2, and 3, respectively. 


Many Line A functions use the COLBITa to determine what color to 
use while drawing. Each of the COLBITs corresponds to one bit plane in the 
Image, and are labelled for which bit plane they affect. COLBITO atlects bit 
plane 0, COLBIT1 bit plane 1, etc. If the value in a COLBIT is zero, the bit is 
cleared in the affected plane. If the value is nonzero, the bit is set in the 
affected plane. 


+032 $020 word 

If LSTLIN is zero, the last pixel in a line is drawn. Nonzero, and the 
fast pixel is not drawn. This is provided in case you are drawing a *®” e * 
connected lines, using a writing mode like XOR, where if two lines try to plot 
the same endpoint it will disappear. 


+034 $022 word 

+036 $024 word 


Equivalent to VDI’s Polyline Type, 
described in the VDI manual, under 
"Set Polyline Line Type". 

Equivalent to VDI’s Writing Mode, 
described in the VDI manual, under 
"Set Writing Mode". 


The four VDI writing modes are: 


(0) Replace Mode -- Ignores the currently displayed Image, replaces it with 
Fore AND Mask i.e. New=(fore AND mask) 

(1) Transparent Mode -- Only affects the pixels where the mask is 1 - These 
are changed lo the foreground value, i.e. New ■ (fore AND mask) OR (old 

AND NOT mask) , , .. 

(2) XOR Mode -- Reverses the bits representing the color. I.e. New - mask 

(3) Reverse T ransparent Mode -- Only affects the pixels where the mask is 0. 
These are changed to the foreground value. I.e. New - (old AND mask; or 
(lore AND NOT mask) 

There are several additional writing modes available for functions like TextBIt: 
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XI 

Y1 

X2 

Y2 


PATPTR 


PATMSK 


MFILL 


CLIP 


OP Combination Rule 

0 D'-O 

1 D' - S AND D 

2 D' - S AND {NOT D) 

3 D’ - S (Replace Mode) 

4 D' - {NOT S] AND D (Erase Mode) 

5 D-D 

6 D' - S XOR D (XOR mode) 

7 D’-SORD 

8 D’ • NOT [S OR D] 

9 D’ - NOT (S XOR D] 

A D' - NOT D 

B D' - S OR [NOT D] 

C D’ - NOT S 

D D' - {NOT S) OR D 

E D' - NOT [S AND D] 

F D- 1 


+038 $026 word 

+040 $028 word 

+042 $02A word 

+044 $02C word 

These variables are otlen used when a Line A routine needs X and Y 
coordinates as input, as with Line and Filled Rectangle. 


xl coordinate 
yt coordinate 
x2 coordinate 
y2 coordinate 


+046 $02E long Pointer to the current till pattern 

Functions like Horizontal Line and Filled Rectangle look here tor the 
address ot their fill pattern. 


+050 $032 word Fill pattern "mask''. 

This value is ANDed with Y1. and the result used as the offset into 
the fili pattern. 

This maintains alignment of the pattern in relation to the screen. In 
most cases, this also acts as the length of the pattern minus one, thus a one 
word pattern would merit a zero, a sixteen word pattern a fifteen, etc. 
Usually, the pattern should be a power of two in length. 


+052 $034 word Multi-plane fill flag: 

If MFILL is zero, the fill pattern is single plane. It MFILL is nonzero, the fill 
pattern is multiple plane. 


+054 $036 


word Clipping flag: 

0-clipping disabled, 
nonzero-clipping enabled 
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XMINCL 

+056 $038 

word 

Minimum X clipping value 

YMINCL 

+058 SOSA 

word 

Minimum Y clipping value 

XMAXCL 

+060 $03C 

word 

Maximum X clipping value 

YMAXCL 

+062 $03E 

word 

Maximum Y clipping value 

XDDA 

+064 $040 

word 

Accumulator for textblt x dda. Should 
be Initialized to $8000 before each 
invocation ol TextBIt that requires 
scaling. 

DDAINC 

+066 $042 

word 

Fractional amount to scale up or down. 


It scaling up, set DDAINC to 256*(lntended Size-Actual size)/Actuai size If 
scaling down, set DDAINC to 256*(lntended size)/ Actual size. 

SCALDIR 

+068 $044 

word 

Scale direction flag (0-down, 1-up) 

MONO 

+070 $046 

word 

Current font monospaced? 

0 * current font is not monospaced OR 
special effects may increase/decrease 
the size of the form. 

1 - current font is monospaced AND 
thickening is the only special effect 
allowed. 

SOURCEX 

+072 $048 

word 

X coord of character in font form 

SOURCEY 

+074 $04A 

word 

Y coord of character in font form 


SOURCEX can be computed from Information held in the font header. (See 
VDI manual tor tont format) 


temp * character value: 
temp ~ fnt_ptr->first ade; 

SOURCEX = tnt_ptr->off table(temp); 


SOURCEY is usually set to zero 

(top line ol the tont torm.) 

DESTX 

+076 $04C 

word 

X coordinate of character on screen 

DESTY 

+078 $04E 

word 

Y coordinate of character on screen 

DELX 

+080 $050 

word 

Width of character 

DELY 

+082 $052 

word 

Height of character 


DELX and DELY can be computed from the tont header, 
temp * character value; 
temp — fnt_ptr->first_ade; 

SOURCEX - f nt_ptr->oft table(temp) ; 

DELX = fnt_ptr->offtable(temp+ 1 )-SOURCEX; 

DELY = fnt_ptr->form_height; 
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FBASE 

+084 $054 

long 

Pointer to font data 

FWIDTH 

+088 $058 

word 

Width of font form 


FBASE and FWIDTH can be retrieved from the font header. 


FBASE * fnt_ptr->datjable; 
FWIDTH - fnt_ptr->form_width; 


STYLE 

+090 $05A 

word 

TextBIt special effects flags 

bit 0 * Thicken flag 

bit 1 - Lighten flag 

bit 2 ■ Skewing flag 

bit 3 - Underline flag 

(Not handled by TextBIt) 

bit 4 « Outline flag 

Set the bits to select the desired 

eftects. Underlining is done by the 

application. 

LITEMASK 

+092 $05C 

word 

Mask used to lighten text (typically 
$5555) 

SKEWMASK 

+094 $05E 

word 

Mask used to skew text (typically 
$5555) 

WEIGHT 

+096 $060 

word 

Width by which to thicken text 

ROFF 

+096 $062 

word 

Offset above character baseline when 
skewing 

LOFF 

+ 100 $064 

word 

Offset below character baseline when 
skewing. 


The above five input variables can be 

computed from the font header. 


LITEMASK = fnt_ptr->lighten; 
SKEWMASK = 1nt_ptr->skew; 
WEIGHT * fnl_ptr->thicken; 

if (skewing) ( 

ROFF = fn!_ptr->rioht_ol!set; 
LOFF = fnt_ptr->iett_offset; 

} 

else { 

ROFF - 0; 

LOFF - 0; 

} 


SCALE 


+ 102 $066 


word 


Scaling flag 
(0”no scaling) 


Section 3: The Line A Verieble Structure 


CHUP 

+104 $068 

word 

Character rotation vector 
0 * normal horizontal orientation 
900 * rotated 90 degrees clockwise 
1800 * rotated 180 degrees clockwise 
2700 - rotated 270 degrees clockwise 

TEXTFG 

+106 $06 A 

word 

Text foreground color 

SCRTCHP 

+ 108 $06C 

long 

Pointer to two contiguous special 
effects buffers for TextBit 

SCRPT2 

+ 112 $070 

word 

Offset to beginning of the second 
buffer in above form. 


Each of these special ellects buffers must be larQe enough to contain the 
worst-case (largest) result of any special effects you Kexrwp 

Determine that size, then set aside twice that amount, with ' SCRtchp 
pointing to the beginning of the buffers. Set SCRPT2 to Indicate the offset to 
the beginning of the second buffer. 

TEXTBG 

+114 $072 

word 

Text background color 

COPYTRAN 

+116 $074 

word 

Copy raster form type llag 
zero * opaque 
Nonzero * transparent 

SEEDABORT 

+118 $076 

long 

Pointer to a routine called from within 
seedfill to allow the till to be aborted. 
The routine is called after each 
horizontal line fill. Initialized to point to 
a dummy routine that returns FALSE 
(0). Returning TRUE (nonzero) aborts 
the seedfill. 
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